home *** CD-ROM | disk | FTP | other *** search
/ Windows 95 Super Collection / Windows 95 Super Collection.iso / win95 / utils / chief200 / chief.faq < prev    next >
Encoding:
Text File  |  1995-09-15  |  12.4 KB  |  294 lines
  1.             CHIEF'S INSTALLER PRO: FREQUENTLY ASKED QUESTIONS
  2.             -------------------------------------------------
  3.  
  4. THIS FAQ LIST CONTAINS A LOT OF VERY USEFUL INFORMATION, AND
  5. CAN SAVE YOU A LOT OF TIME. PLEASE READ IT CAREFULLY!!!
  6.  
  7. AND, PLEASE READ this file BEFORE contacting me with any questions!!
  8.      ^^^^^^                ^^^^^^
  9. IT PROBABLY CONTAINS ANSWERS TO THOSE QUESTIONS YOU MIGHT WISH TO
  10. ASK, AND TO THOSE WHICH YOU HAVEN'T EVEN THOUGHT OF!
  11.  
  12.  
  13. [--------------------------- CHIEF'S FAQ LIST -----------------------]
  14.  
  15. 1.    Q: WHAT RESERVED WORDS (COMMANDS) DO I ACTUALLY *NEED* IN MY
  16.          WINSTALL.INF FILE?
  17.  
  18.       A: Most of the commands in the INF file are optional. However, some
  19.          of them are essential. At the absolute minimum, you MUST have the
  20.          following;
  21.                    $TITLE
  22.                    $DISK1
  23.                    $SPACE
  24.                    $TARGET
  25.  
  26.  
  27. 2.    Q: WHAT FILES IN THE CHIEF'S INSTALLER PRO PACKAGE ARE ABSOLUTELY
  28.          NECESSARY FOR AN INSTALLATION?
  29.  
  30.       A: As with the commands, most of the files in the package are
  31.          optional. At the absolute minimum, you must have;
  32.                    INSTALL.EXE
  33.                    WINSTALL.INF
  34.  
  35.          The installation will run perfectly well with these two files.
  36.          However, if you want the "banner" to be displayed, you must also
  37.          have WINSTALP.DLL. If you are using a language other than
  38.          English, you must have a copy of WINSTALL.DLL compiled with the
  39.          string resources translated to your language.
  40.  
  41.          If you want to use $UNZIP (or the UNZIP command) then you must
  42.          have WINSTALZ.DLL.
  43.  
  44.          If you want to change the default icon on the installer's dialog
  45.          boxes, then you also need WINSTALC.DLL.
  46.  
  47.          If your program comes on more than 1 installation disk, then it
  48.          is advised to ask your users to run SETUP.EXE instead of
  49.          INSTALL.EXE. SETUP.EXE will call INSTALL.EXE at the right point,
  50.          and running it avoids a lot of potential problems.
  51.  
  52.  
  53.  
  54. 3.    Q: WHY DO I ALWAYS GET A DIALOG TELLING ME THAT THE INSTALLATION
  55.          IS NOT COMPLETE WHEN I KNOW THAT IT IS?
  56.  
  57.       A: If indeed, all the files have been correctly installed:
  58.          The installer tries to match the figure in your $SPACE line with
  59.          the sizes of the files installed (to approximately 2% either way).
  60.          A substantial (more than 2%) discrepancy leads to this error
  61.          dialog. One solution is to make sure that your $SPACE information
  62.          is accurate, or to disable the end dialog by using the
  63.          $NO-END-DIALOG command, but the best solution is to make sure that
  64.          the figure specified in your $SPACE line is accurate.
  65.  
  66.          Note that if you do not ensure the accuracy of your $SPACE line,
  67.          the progress "percent" meter will also not be accurate - and in
  68.          such cases, you SHOULD use $NO-END-DIALOG otherwise your users
  69.          will get a spurious error message which will confuse them into
  70.          thinking that the installation has failed.
  71.  
  72.          The easiest way to calculate ALL your space requirements is to
  73.          run AUTOCALC.EXE.
  74.  
  75.          Please NOTE question 7 (below) as well.
  76.  
  77.  
  78. 4.    Q: I HAVE SPECIFIED CERTAIN FILES TO BE INSTALLED INTO THE WINDOWS
  79.          SYSTEM DIRECTORY WITH THE $SYSDIR COMMAND. WHY ARE THEY NOT BEING
  80.          INSTALLED?
  81.  
  82.       A: The $SYSDIR, $WINDIR, $TEMPDIR, and $DEST lines only specify the
  83.          DESTINATION of the files on those lines (the default is to install
  84.          all files into the directory pointed to by $TARGET). When you
  85.          use any of these, you still have to put those files on your $DISK
  86.          lines, otherwise, they will not be installed at all.
  87.  
  88.          Another possible cause is that your files are compressed, and you
  89.          are putting their compressed names (with underscores and all) on
  90.          these lines. The only place where you should use the file names
  91.          with the underscores (if they are compressed with the -r switch)
  92.          is on the $DISK lines. In EVERY other place where you specify file
  93.          names, you MUST use the original names of the files (i.e., the
  94.          names of the uncompressed files, before they were compressed).
  95.  
  96.  
  97. 5.    Q: IN WHAT ORDER SHOULD THE ENTRIES IN MY INF FILE APPEAR?
  98.  
  99.       A: The whole INF file is read and processed at once. This means that
  100.          the order is which the reserved words appear is not important in
  101.          most cases.
  102.  
  103.          However, note that $USER-OPTION lines MUST appear before $OPTIONAL
  104.          lines, and that any reserved word which is numbered (e.g., $DISK,
  105.          $USER-OPTION, $OPTIONAL) must appear and be numbered in the correct
  106.          numerical order.
  107.  
  108.  
  109. 6.    Q: IN WHAT LANGUAGE IS YOUR INSTALLER WRITTEN, AND WILL YOU SUPPLY
  110.          THE SOURCE CODE (ON PAYMENT OF A FEE)?
  111.  
  112.       A: Chief's Installer Pro is written in Borland Pascal 7.01, and Borland
  113.          Delphi. I am sorry I cannot supply the source code.
  114.  
  115.  
  116. 7.    Q: AUTOCALC SEEMS TO BE GETTING THE DISK SPACE CALCULCATIONS WRONG.
  117.          WHAT GIVES?
  118.  
  119.       A: There are many causes for wrong calculations by AUTOCALC. The
  120.          primary cause is indiscriminate use of wildcards in your INF
  121.          file. Other causes, which might be related to the one already
  122.          mentioned are:
  123.  
  124.             [a] Mixing wildcards and full file names on $DISK, $SYSDIR,
  125.                 $WINDIR, $TEMPDIR, and $OPTIONAL lines - this might
  126.                 result in some files being processed more than once.
  127.  
  128.             [b] Having files in the directories being processed by
  129.                 AUTOCALC which files are not going to be on your
  130.                 distribution disks.
  131.  
  132.          The bottom line is this - if you are going to use wildcards on
  133.          your $DISK and/or $OPTIONAL lines, you need to think very
  134.          carefully about what you are doing. It is up to you to arrange
  135.          your lines so that no file is liable to be processed twice -
  136.          this is because AUTOCALC processes your INF file _exactly_ as
  137.          it finds it.
  138.  
  139.          In my view, it advisable to AVOID mixing wildcards and full file
  140.          names on $OPTIONAL lines. The $OPTIONAL lines in SAMPLE4.INF
  141.          are a good example of what will cause wrong calculations by
  142.          AUTOCALC.
  143.  
  144.  
  145. 8.    Q. SOMETIMES I GET AN ERROR MESSAGE THAT THE DISK CANNOT BE READ.
  146.      WHY DOES THIS HAPPEN?
  147.  
  148.       A. This sometimes happens when you are doing a multi-disk install,
  149.          and you have run INSTALL.EXE (instead of SETUP.EXE). This is
  150.          because Windows may have swapped out parts of INSTALL.EXE to
  151.          create room for other things to run, and now has to read
  152.          those parts again from INSTALL.EXE. If INSTALL.EXE is on disk 1
  153.          and you are currently on another disk (e.g., disk 3) then
  154.          INSTALL.EXE will not be found, and the error will occur.
  155.  
  156.          The best was to avoid this type of problem is to follow the
  157.          principle that IF THERE IS MORE THAN ONE DISK IN YOUR INSTALLATION
  158.          SET, YOU SHOULD ALWAYS RUN SETUP.EXE (AND NOT INSTALL.EXE).
  159.          SETUP.EXE will call INSTALL.EXE at the appropriate point.
  160.  
  161.  
  162. 9.    Q  IF I WANT MY USERS TO RUN SETUP.EXE AND I WISH TO PREVENT THEM FROM
  163.          RUNNING INSTALL.EXE, HOW CAN I DO THIS?
  164.  
  165.       A. You can compress INSTALL.EXE with Microsoft's COMPRESS.EXE (if you
  166.          have a copy), with the  -r switch.
  167.  
  168.              i.e., "COMPRESS -r INSTALL.EXE"
  169.  
  170.  
  171.          This will compress the file to INSTALL.EX_  - which of course your
  172.          users cannot run. When SETUP.EXE is executed, it will look first for
  173.          INSTALL.EXE. If that is not found, then it will look for INSTALL.EX_
  174.          and decompress it to the TEMP directory, and then it will run it.
  175.  
  176.          NOTE: if you compress INSTALL.EXE you MUST use the -r switch.
  177.  
  178.  
  179. 10.   Q. YOU KEEP TALKING ABOUT MICROSOFT'S COMPRESS.EXE IN YOUR
  180.          DOCUMENTATION; HOW CAN I GET A COPY?
  181.  
  182.       A. COMPRESS.EXE is normally bundled with Windows development tools.
  183.          Microsoft has not permitted me to bundle it with Chief's
  184.          Installer Pro. However, if you have a Borland or Microsoft compiler,
  185.          you probably have the program already (usually in your compiler's
  186.          BIN directory).
  187.  
  188.          I understand that a copy of COMPRESS.EXE is lurking around on the
  189.          internet somewhere, but I am afraid I cannot give further details.
  190.  
  191.          If you conduct an ARCHIE search of internet FTP sites, you may be
  192.          able to find a reference to it. If you do find it on an ftp site,
  193.          please do NOT tell me about it (because it is probably not on the
  194.          net legally).
  195.  
  196.          And, sorry, NO, I cannot send you a copy (perhaps Microsoft can).
  197.  
  198.          In any case, you can ZIP your files and then use the $UNZIP command
  199.          to install them - you will probably get a greater compression ratio
  200.          than using the LZW compression in Microsoft's COMPRESS.EXE.
  201.  
  202.  
  203.  
  204. 11.   Q. I WISH TO INSTALL A FILE INTO MORE THAN ONE DIRECTORY. HOW CAN I
  205.          DO THIS?
  206.  
  207.       A. You need to set $MAX-DUPLICATES to a number which is equal to, or
  208.          higher than the number of different directories you may want to
  209.          install the file to.
  210.  
  211.          e.g., $MAX-DUPLICATES=5
  212.  
  213.          Note however, that the higher the figure here, the slower your
  214.          installation will proceed, because the installer will have to loop
  215.          through the $DEST lines at least the number of times that you
  216.          specify in $MAX-DUPLICATES. So you really do not want to set the
  217.          value here too high. A maximum of 3 is probably a good trade-off
  218.          for performance reasons. If you do not care much about speed, then
  219.          you can set it to as high as 30.
  220.  
  221.  
  222. 12.   Q. IF I WISH TO USE THE FULL RANGE OF FEATURES IN CHIEF'S INSTALLER PRO,
  223.          WHICH FILES MUST I HAVE ON MY DISTRIBUTION DISKS?
  224.  
  225.       A. Really, the only files that are absolutely necessary are;
  226.               INSTALL.EXE
  227.               WINSTALL.INF
  228.  
  229.            However, if you have only these files on your disk, many features will
  230.            be missing. For an installation program having the full range of features
  231.            offered by Chief Pro, you need all these files on your DISK #1
  232.  
  233.                1. SETUP.EXE    - loader for the installer
  234.                2. SETUPINF.INF    - INF file for SETUP.EXE
  235.                3. INSTALL.EXE    - main installer
  236.                4. WINSTALL.INF    - INF file for INSTALL.EXE
  237.         5. WINSTALL.HLP    - help file for the installation
  238.                6. WINSTALP.DLL    - for the banner window
  239.                7. WINSTALZ.DLL    - for UNZIP functions
  240.                8. WINSTALC.DLL    - for the dialog icons
  241.                9. WINSTALL.TXT    - for the README button
  242.                10.WINSTALL.MSG    - for the message dialog during the install
  243.                
  244.     ALL these files, except #1 and #2 (SETUP.EXE SETUPINF.INF) CAN
  245.     be compressed on your DISK #1. SETUP.EXE will decompress them
  246.     automatically. Thus, you can follow these steps (or run a DOS
  247.     batch file that goes something like this):
  248.  
  249.         REM --- MAKEDSK1.BAT -----------
  250.         REM --- A DOS BATCH FILE TO COPY INSTALL FILES TO DISK #1
  251.         @ECHO OFF
  252.         C:
  253.         CD \TEMP
  254.         MD C:\TEMP\DIST
  255.         COPY SETUP.EXE C:\TEMP\DIST
  256.         COPY SETUPINF.INF C:\TEMP\DIST
  257.         COMPRESS -r INSTALL.EXE  C:\TEMP\DIST
  258.         COMPRESS -r WINSTALL.INF C:\TEMP\DIST
  259.         COMPRESS -r WINSTALL.HLP C:\TEMP\DIST
  260.         COMPRESS -r WINSTALL.TXT C:\TEMP\DIST
  261.         COMPRESS -r WINSTALL.MSG C:\TEMP\DIST
  262.         COMPRESS -r WINSTALP.DLL C:\TEMP\DIST
  263.         COMPRESS -r WINSTALZ.DLL C:\TEMP\DIST
  264.         COMPRESS -r WINSTALC.DLL C:\TEMP\DIST
  265.         ECHO INSERT DISK #1 IN DRIVE A:
  266.         PAUSE > NUL
  267.         CD C:\TEMP\DIST
  268.         COPY *.* A:\
  269.         
  270.  
  271. 13.   Q. I WOULD LIKE TO PUT ALL MY APPLICATION'S FILES IN ZIP ARCHIVES AND
  272.          THEN UNZIP THEM AT INSTALL TIME. CAN I DO THIS?
  273.  
  274.       A. The answer is "YES". The easiest way to do this is to put the files
  275.          for each disk in one (or more) ZIP files, put those files on the
  276.          relevant disks, and then use the $UNZIP command on the $DISK# lines.
  277.  
  278.            e.g.,
  279.                $DISK1=$UNZIP;$SOURCEDIR\PROG100.ZIP;$DEST;CONFIRM
  280.                $DISK2=$UNZIP;$SOURCEDIR\PROG200.ZIP;$DEST;CONFIRM
  281.                $DISK3=$UNZIP;$SOURCEDIR\PROG300.ZIP;$DEST\SRC;SKIP
  282.                $DISK4=$UNZIP;$SOURCEDIR\PROG400.ZIP;$DEST\DOC;SKIP
  283.          
  284.  
  285.  
  286. ----------------------------------
  287. Dr Abimbola Olowofoyeku (The Chief)
  288. September 1995
  289.  
  290. E-mail: laa12@keele.ac.uk
  291.         chief@mep.com
  292.  
  293.  
  294.